home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / tjpoke10.zip / VIDEOP.DOC < prev    next >
Text File  |  1993-01-10  |  19KB  |  479 lines
  1.  
  2.  
  3.                        ============================
  4.                              T&J Video Poker!
  5.                        ============================
  6.                            (c)1993 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  11.  
  12.                     VERSION 1.00     January 10, 1993
  13.  
  14.                                    By
  15.  
  16.                             Tom & Jane Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30. LATEST VERSION:
  31. ===============
  32.  
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35. LEGALITIES:
  36. ===========
  37.  
  38. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  39. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  40. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  41. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  42. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  43. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  44. DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  45. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  46. A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  47.  
  48. DISTRIBUTION:
  49. =============
  50.  
  51. You may make this file available for downloading from your BBS or you may
  52. upload it to any BBS of your choice, provided that you do not make any
  53. changes to the contents of the archive (ZIP file). The archive and its
  54. individual contents may not be used by any service that charges any money
  55. whatsoever, without the written permission of the author.
  56.  
  57. VERIFY:   VIDEOP.EXE  244,190  1-10-1993  4:09p
  58.  
  59.  
  60. PROGRAM DESCRIPTION:
  61. ====================
  62.  
  63. Welcome to T&J Software's Video Poker!
  64.  
  65.    Video Poker is setup to duplicate the standard video poker type of
  66.    machine which are found in various locations.
  67.  
  68.    Basically, you select your bet by pressing any of the number keys
  69.    (from 1 to 9) and the first set of five cards appear. You then
  70.    select the cards you wish to keep by selecting the card number
  71.    (from 1 to 5). A yellow 'KEEP' will flash below your choosen cards.
  72.    You then select 'D' or simply hit the ENTER key for your second
  73.    draw of cards.
  74.  
  75.    A small status display in the upper right portion of then main
  76.    screen tells you your current hand status by placing a blinking
  77.    check mark inside the brackets.
  78.  
  79.    On the very top of the screen, you'll see how your SysOp has the
  80.    game configured for payoffs. Let's say it says "You need JACKS or
  81.    better." That means the game will not payoff unless you have at
  82.    least a pair of JACKS. Anything less than that will not payoff.
  83.  
  84.    This door resets every monday during the BBS maintenance. So, if
  85.    you're running behind bet it all on Sunday evenings! You never
  86.    know, you may catch up or surpass the leader!
  87.  
  88.    Each new bet starts the turn with a new deck of cards.
  89.  
  90.    The status of the payoffs can be viewed by pressing the 'P' key.
  91.    This will show you the payoff versus what card combinations you
  92.    have. On the right, it shows what combinations had already come up.
  93.  
  94.    The game also keeps track of the all time high score and last weeks
  95.    high score. These can be viewed by pressing the 'V' key.
  96.  
  97.    In case you get some line garbage, you can always press the 'R' key
  98.    to quickly redraw the current screen.
  99.  
  100.    Want to view the top ten players? Just tap the 'T' key and you'll
  101.    be presented with the current top ten. As you play, check this and
  102.    watch your name crawl up the list!
  103.  
  104.    When you're ready to quit the game, just hit the 'Q' key and the
  105.    game will generate the current top ten list and the bulletins.
  106.  
  107.    If you run out of money, you're finished until monday when the door
  108.    resets. So watch how much you bet!
  109.  
  110.    This door also has a BONUS feature which your sysop may or may not
  111.    choose to use. Basically, a certain amount of money is placed in
  112.    the jackpot each time you play a hand of poker. The best hand of
  113.    the day will receive this jackpot money tomorrow! Be sure to logon
  114.    and claim the money, or you lose it!
  115.  
  116.    High hand numbers are determined like this:
  117.  
  118.          Royal Flush           =  100,000 points
  119.          Straight Flush        =  50,000
  120.          Four of a Kind        =  25,000
  121.          Full House            =  12,500
  122.          Flush                 =  10,000
  123.          Straight              =  7,500
  124.          Three of a Kind       =  5,000
  125.          Two Pair              =  2,500
  126.          One Pair              =  1,000
  127.  
  128.    In addition to these points, you then add the card values
  129.    themselves. A two = 2 points and so on up to an Ace = 14 points.
  130.    So, if you draw a Full House with 2-Fours and 3-Aces, your hand
  131.    value would be 12,550. Somebody would have to beat your 12,550
  132.    point hand to claim the jackpot tomorrow! You'll be told when you
  133.    quit the game if you have the high hand thus far!
  134.  
  135.    That's about it, if you have any comments of suggestions for the
  136.    door please get in touch with us!
  137.  
  138. NOTE:
  139. =====
  140.  
  141. There is no KEY file for this door, instead once registered, you will
  142. be given a CODE NUMBER to put into your SYSOP.CFG file which will
  143. unlock the door for more plays per day. Until it is registered, you
  144. are limited to one door entry per day and five plays per play. When
  145. you get your CODE number, you will also be told EXACTLY how to enter
  146. your BBS name and SYSOP name in the CFG file.
  147.  
  148. This door does not expire!
  149.  
  150. By running VIDEOP LOCAL, the SysOp can play the door without any
  151. crippling to better evaluate the door.
  152.  
  153.  
  154. FEATURES:
  155. =========
  156.            --- Desqview Aware.
  157.            --- COM1-4 support and non-standard IRQ's.
  158.            --- Colorful ANSI screens.
  159.            --- Chat function with automatic screen redraw.
  160.            --- Drop to DOS with automatic screen redraw.
  161.            --- NO BRUN module needed for play.
  162.            --- BETA tested on many different boards.
  163.            --- Will return to BBS on dropped carrier.
  164.            --- Will TIMEOUT a player after 5 minutes of no activity.
  165.            --- Use of HOT KEYS while in the door.
  166.            --- Support BBS available.
  167.            --- TOP TEN bulletins.
  168.            --- SysOp configurable.
  169.            --- Fossil Driver support.
  170.  
  171.  
  172. INSTALLATION:
  173. =============
  174. Run Video Poker with the command line UTILITY. (VIDEOP UTILITY)
  175.  
  176. Next, RESET the DOOR!! Select number 1 from the UTILITY menu! This
  177. will reset everything from scratch.
  178.  
  179. Next, select number 2 from the UTILITY menu and make sure the high
  180. score files have been reset.
  181.  
  182. Next, select number 3, set the SYSOP.CFG file -- answer all the
  183. questions here.
  184.  
  185. Finally, select number 4, set the VIDEOP.CFG file.
  186.  
  187.  
  188. CONFIGURATION: (Your VIDEOP.CFG file)
  189. =============
  190.  
  191. Example configuration file for PCBOARD.SYS
  192. ------------------------------------------
  193.  
  194. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  195. T&J Software        <=-  (Change this to your BBS name)
  196. Tom                 <=-  (The Sysop's first name)
  197. Wildoner            <=-  (The Sysop's last name)
  198.  
  199. Example configuration file for USERS.SYS
  200. ----------------------------------------
  201.  
  202. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  203. T&J Software        <=-  (Change this to your BBS name)
  204. Tom                 <=-  (The Sysop's first name)
  205. Wildoner            <=-  (The Sysop's last name)
  206.  
  207. Example configuration file for DOOR.SYS
  208. ---------------------------------------
  209.  
  210. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  211. T&J Software        <=-  (Change this to your BBS name)
  212. Tom                 <=-  (The Sysop's first name)
  213. Wildoner            <=-  (The Sysop's last name)
  214.  
  215. Example configuration file for USERINFO.DAT
  216. -------------------------------------------
  217.  
  218. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  219. T&J Software        <=-  (Change this to your BBS name)
  220. Tom                 <=-  (The Sysop's first name)
  221. Wildoner            <=-  (The Sysop's last name)
  222. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  223.  
  224. Example configuration file for CALLINFO.BBS
  225. -------------------------------------------
  226.  
  227. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  228. T&J Software        <=-  (Change this to your BBS name)
  229. Tom                 <=-  (The Sysop's first name)
  230. Wildoner            <=-  (The Sysop's last name)
  231.  
  232. Example configuration file for DORINFOx.DEF
  233. -------------------------------------------
  234.  
  235. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  236.                           where 'x' is the BBS Node number.
  237. T&J Software        <=-  (Change this to your BBS name)
  238. Tom                 <=-  (The Sysop's first name)
  239. Wildoner            <=-  (The Sysop's last name)
  240.  
  241. Example configuration file for SFDOORS.DAT
  242. ------------------------------------------
  243.  
  244. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  245. T&J Software        <=-  (Change this to your BBS name)
  246. Tom                 <=-  (The Sysop's first name)
  247. Wildoner            <=-  (The Sysop's last name)
  248.  
  249. Example configuration file for CHAIN.TXT
  250. ----------------------------------------
  251.  
  252. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  253. T&J Software        <=-  (Change this to your BBS name)
  254. Tom                 <=-  (The Sysop's first name)
  255. Wildoner            <=-  (The Sysop's last name)
  256.  
  257. Example configuration file for GTUSER.BBS
  258. -----------------------------------------
  259.  
  260. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  261. T&J Software        <=-  (Change this to your BBS name)
  262. Tom                 <=-  (The Sysop's first name)
  263. Wildoner            <=-  (The Sysop's last name)
  264. 1                   <=-  (COM port number - defaults to 1)
  265. 1                   <=-  (Node number - defaults to 1)
  266.  
  267. ** Please see your individual door documentation on setting up doors!
  268.  
  269. Example Batch File
  270. ==================
  271.  
  272. A sample batch file similar to the following:
  273.    ECHO OFF
  274.    CD\DOORS\VIDEOP          <=- Switch to the door's Directory.
  275.    VIDEOP VIDEOP.CFG        <=- Execute the door program and pass the
  276.                                 configuration filename to the program.
  277.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  278.    BOARD                    <=- Restart BBS.
  279.  
  280. This Door is multi-node  compatible so you may run more than 1 node from
  281. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  282. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  283. variables, (q.v.)
  284.  
  285. Environment Variables
  286. =====================
  287.  
  288. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  289. variables. Non-PCBoard systems may also use these variables by including
  290. the following in either your BBS batch or AUTOEXEC.BAT
  291.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  292.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  293. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  294. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  295. .CFG file for multi-node operation!
  296.  
  297. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  298. command line.  For example:
  299.  
  300.      VIDEOP VIDEOP.CFG /5
  301. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  302.      VIDEOP VIDEOP.CFG /%IRQ%
  303.  
  304. This tells the program to use IRQ 5 instead of the standard IRQ.
  305.  
  306.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  307.  systems. Seems Novell also uses the / character so something went screwy
  308.  somewhere. So I added the * (asterisk) which may be used instead of the /
  309.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  310.  and are interchangeable.
  311.  
  312. When specifying the location of the system file on line 1 of the doors .CFG
  313. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  314. and %wcnodeid%. Some examples:
  315.  PCBoard: 
  316.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  317.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  318.  
  319.  Wildcat!:
  320.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  321.  
  322. Non-PCBoard systems may use the PCB environment variables by setting them
  323. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  324.  SET PCBDRIVE=C:
  325.  SET PCBDIR=\BBSDIR
  326.  SET PCBNODE=1
  327.  
  328. Fossil Driver Support
  329. ---------------------
  330. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  331. Fossil driver instead of the standard COM ports, just put /FD on the command
  332. line when running the door. For example:
  333.      MYDOOR MYDOOR.CFG /FD
  334. indicates that a Fossil driver is present and should be used. If no Fossil
  335. driver is detected, DoorFrame will print a message to that effect and exit
  336. the door gracefully.
  337.  
  338.  
  339. Sysop Keys
  340. ==========
  341.  
  342. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  343.          written to DOOR.SYS and USERS.SYS
  344. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  345.          and/or written to DOOR.SYS and USERS.SYS
  346. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  347. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  348.          and/or written to DOOR.SYS and USERS.SYS
  349. F8    -  Returns the caller involuntarily to the BBS.
  350. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  351.          and/or written to DOOR.SYS and USERS.SYS
  352. F10   -  Activates SysOp CHAT mode within the DOOR.
  353. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  354. UP    -  Give the caller extra time while in the DOOR.  
  355. DN    -  Subtract time from the caller while in the DOOR. 
  356. HOME  -  HELP key for Status Line options.
  357. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  358. ALT-X -  PCBoard will exit after current caller logs off. Value is
  359.          passed to PCBoard. Not available on non-PCBoard systems.
  360.  
  361.  
  362. SYSOP.CFG FILE:
  363. ==============
  364.  
  365. 50
  366. c:\wc30\bull\bull99.scr
  367. c:\wc30\bull\bull99.bbs
  368. 2
  369. 1000
  370. 11
  371. 0
  372. Y
  373. 1000
  374.  
  375. LINE 1: Plays per entry into the door.  (30-50 recommended)
  376. LINE 2: Color bulletin path
  377. LINE 3: Mono bulletin path
  378. LINE 4: Entries per day.
  379. LINE 5: Starting money. I'd leave this at 1000.
  380. LINE 6: This is where you set the payoff amount of the door:
  381.         2= 2's or better, 3= 3's or better......
  382.         11= Jack's or better, 12= Queen's or better,
  383.         13= King's or better, 14= Ace's or better.
  384. LINE 7: Your REGISTRATION CODE  0 if not registered.
  385. LINE 8: Enable the BONUS option or not. Y=Enabled N=Disbaled
  386. LINE 9: Amount of money added to the BONUS jackot for every hand
  387.         played.
  388.  
  389.  
  390. MAINTENANCE:
  391. ===========
  392.  
  393. After the initial setup, you must run a maintenance routine after
  394. midnight. Switch to the door directory and run:
  395.  
  396.                  VIDEOP MAINT
  397.  
  398. The door will reset every monday!
  399.  
  400. PLAYING LOCALLY:
  401. ===============
  402.  
  403. Just type VIDEOP LOCAL
  404.  
  405.  
  406. FUTURE VERSIONS:
  407. ================
  408.  
  409. ---> We will be adding make-up day routines in the next version. We're
  410.      not sure how we're going to work this right now though.
  411.  
  412.  
  413. COMMENTS & QUESTIONS:
  414. ====================
  415.  
  416. Q: I'm running DESQview/X and the door is having some problems with
  417.    keyboard timeouts and things like that!!
  418. A: Make sure you have the MATH COPROCESSOR flagged ON, even if you don't
  419.    have one! This is a problem with DV/X and not the door.
  420.  
  421. Q: I keep getting an error #53 right when the door starts!!
  422. A: Error #53 means a file is not found. If this occurs right from the
  423.    start, odds are the door isn't finding the caller information file.
  424.    Check the PATH to your caller information file located located
  425.    on the first line of the VIDEOP.CFG file.
  426.  
  427.  
  428. PROBLEMS:
  429. ========
  430.  
  431. If any internal errors do occur, check for a file called DFRAME.ERR
  432. and let me know what the error code says.
  433.  
  434. Several people have been having problems with their Trident SVGA
  435. cards and the ANSI screens not showing up correctly. To fix this,
  436. check you utility disk that came with your Trident card for a program
  437. called TANSI.SYS or something similar. Replace your old ANSI.SYS
  438. with this version of it. This will correct the problems.
  439.  
  440. Please feel free to contact me if you have any problems at all.
  441.  
  442.  
  443.                             QuickBasic Error codes
  444.                       DoorFrame uses the QB error codes.
  445.  ---------------------------------------------------------------------------
  446.  
  447.  2   Syntax Error                       61   Disk full
  448.  5   Ilegal Function Call               62   Input past end of File
  449.  6   Overflow                           63   Bad record number
  450.  7   Out of memory                      64   Bad filename
  451. 11   Division by Zero                   67   Too many files
  452. 13   type mismatch                      68   Device unavailable
  453. 24   Device Timeout                     69   Comm-buffer overflow
  454. 25   Device fault                       70   Permission denied
  455. 52   Bad filename or number             71   Disk not ready
  456. 53   File Not Found                     72   Disk media error
  457. 55   File Already open                  74   Rename across disk
  458. 57   Device I/O error                   75   Path/File access error
  459. 58   File already exists                76   Path not found
  460. 59   Bad Record length
  461.  
  462.      The most common error that you will see is #62.  This is usually caused
  463. by the CFG file not having enough lines.  I have included this list so
  464. that you may be able to fix a problem that occurs with a T&J Software
  465. door.
  466.  
  467. VERSION HISTORY:
  468. ===============
  469. See the HISTORY.TXT file for information on the history of the game
  470. and the new options in the new versions!
  471.  
  472. REGISTERING:
  473. ============
  474. That's all there is to it! If you have any problems or questions
  475. please feel free to call the T&J BBS at (717)325-9481 and join the
  476. T&J Software Conference.
  477.  
  478. See the enclosed registration form for ordering!  (REGISTER.TXT)
  479.